home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr26 / enviro30.zip / ENVIRO.DOC next >
Text File  |  1993-06-01  |  13KB  |  280 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                   ENVIRO v3.0
  19.                                   ~~~~~~~~~~~
  20.  
  21.                              by George Silberstern
  22.  
  23.  
  24.  
  25.                               DISTRIBUTION ARCHIVE
  26.  
  27.     The following files should have been included in the archive containing 
  28.     this program: 
  29.  
  30.       ENVIRO  EXE   6512   02-10-93   03:00 The ENVIRO Executable program
  31.       ENVIRO  DOC  13182   02-10-93   03:00 This file - User Manual
  32.       FILE_ID DIZ    360   02-10-93   03:00 Description info for BBSes
  33.  
  34.     If any of these files are missing, then you may not have an original 
  35.     copy of the archive.
  36.  
  37.  
  38.  
  39.                                   ABOUT ENVIRO
  40.  
  41.     A number of years ago, PC-Magazine published a very brief utility that 
  42.     would provide users with the location of the Environment buffer.  since 
  43.     that article appeared, I've been bashing my head in trying to come up 
  44.     with an easy way to find out how that buffer is being used.  
  45.  
  46.     MS-DOS allocates a default size to the buffer, but doesn't provide for 
  47.     a clear way to determine how it is being used.  Sure, there is the SET 
  48.     command, but it is only good to see what is in it.  Even Digital 
  49.     Research makes no such provisions in DR-DOS, and I've yet to see 
  50.     something that does more than what the SET command provides for.
  51.  
  52.     After agonizing over it, I finally came up with a solution in the form 
  53.     of this program.  ENVIRO now makes it possible to not only find out 
  54.     where in memory the buffer resides, but also how big it is.  But that 
  55.     is not all, as it also indicates how many bytes are in use, and how 
  56.     many remain free.  As an added bonus, the content of the Environment 
  57.     buffer is also displayed, giving an idea of how that space is being 
  58.     used.
  59.  
  60.     This utility was churned out using Borland's Turbo Pascal compiler.  
  61.     The first version I created only provided me with the buffer size and 
  62.     location.  In due course, I decided to add the usage statistics.  Since 
  63.     I wrote both versions for my personal use, I was not too concerned with 
  64.     cosmetic appearances (in fact, I just dumped the figures without even 
  65.     as much as a description of what they were).
  66.  
  67.     I recently concluded that this would really be a useful utility for 
  68.     others to have.  This, made me decide to work on the program yet again.  
  69.     It is the third re-work of ENVIRO.  New to it are the displaying of the 
  70.     contents of the Environment Buffer, the DOS version in use, and yes, 
  71.     labels for everything <grin>.  It is also its first release it to the 
  72.     electronic community.
  73.  
  74.  
  75.  
  76.                             HOW ENVIRO CAN HELP YOU
  77.  
  78.     If you ever wondered how you are using the Environment Buffer on your 
  79.     computer, you will definitely benefit from using ENVIRO.  This is 
  80.     especially true if you ever tried to run an application and saw the DOS 
  81.     Error message, "Out of Environment Space".  That message basically 
  82.     means that your system's Environment Buffer is full, and some or all of 
  83.     the environment parameters required by the application, were not set up 
  84.     properly for that reason.  ENVIRO will let you see everything you need 
  85.     to know in one shot.
  86.  
  87.  
  88.  
  89.                                   USING ENVIRO
  90.  
  91.     ENVIRO is very simple to use, as it requires no Command Line parameters 
  92.     to be entered when run.  All you need to do is type ENVIRO, and press 
  93.     the <Enter> key.  If you need to learn how to change the size of the 
  94.     Buffer, and/or you're interested in the technical details of what the 
  95.     program tells you, this is all there is to know about ENVIRO.
  96.  
  97.     The following statistics are displayed by ENVIRO every time the utility 
  98.     is run:
  99.  
  100.        ■ BUFFER ADDRESS - This is the Memory Address at which the
  101.          Environment Buffer begins.  The address is in Hexadecimal
  102.          notation.
  103.        ■ BUFFER SIZE - This is the amount of space that has been
  104.          allocated to the Buffer.  Unless you modified its size,
  105.          this will be the default value assigned by DOS.  Default
  106.          Buffer sizes are discussed later.  The number is the sum
  107.          of the "Bytes in use" and "Bytes free" values.  Each byte
  108.          represents one character.
  109.        ■ BYTES IN USE - This is the number of bytes in the Buffer
  110.          that are in use.
  111.        ■ BYTES FREE - This is the number of bytes in the Buffer
  112.          that are still available.  Once this value reaches zero,
  113.          DOS will display the "Out of Environment Space" message
  114.          every time you try to add data to the Buffer.
  115.        ■ DOS VERSION - This is the version of DOS in use on your
  116.          system.
  117.  
  118.     Following these statistics, ENVIRO displays the actual contents of the 
  119.     Environment Buffer.  This is the very same information you can obtain 
  120.     by issuing the SET command.
  121.  
  122.  
  123.                            ADJUSTING THE ENVIRONMENT
  124.  
  125.     DOS provides a default Environment Buffer size that can be just this 
  126.     side of "too small" for some applications.  This is especially true in 
  127.     older versions of DOS.  The default size of the Buffer depends on the 
  128.     version of DOS you are using, as per the following table: 
  129.  
  130.            │ Version   │ Low │ High  │Deflt│    ┌──────────────────┐
  131.            ╞═══════════╪═════╪═══════╪═════╡    │All values listed │
  132.            │ MSDOS 3.3 │ 160 │ 32768 │ 160 │    │in this table, are│
  133.            ├───────────┼─────┼───────┼─────┤    │expressed in bytes│
  134.            │ MSDOS 5.0 │ 160 │ 32768 │ 256 │    ├──────────────────┤
  135.            ├───────────┼─────┼───────┼─────┤    │DFT = Default Size│
  136.            │ DRDOS 6.0 │ 512 │ 32751 │ 512 │    └──────────────────┘
  137.            └───────────┴─────┴───────┴─────┘
  138.  
  139.     When the Buffer is full, DOS will display the "Out of Environment 
  140.     Space" message whenever an attempt at adding characters to it is made. 
  141.     If you get this message, it means that it is time to increase the size 
  142.     of the Buffer, or to edit the data placed into it.  The latter isn't 
  143.     always the right solution, so it is best to increase the space 
  144.     allocated to the Buffer. 
  145.     
  146.     There are two ways of doing this, and they are identical in almost 
  147.     every respect.  Both require you to load a new copy of the command 
  148.     processor, COMMAND.COM, but how this is done is what varies: 
  149.  
  150.        1] Batch File - To load a new copy of COMMAND.COM via a Batch file,
  151.           add this statement to a .BAT file (preferably AUTOEXEC.BAT):
  152.                              COMMAND /E:xxxxx [/P]
  153.  
  154.           This method is ideal for customizing the Environment Buffer on 
  155.           the fly.  You can always restore the original Buffer size by 
  156.           using the EXIT command if you don't use the optional /P switch.
  157.  
  158.        2] Configuration File - To boot the system with the modified Buffer 
  159.           size, add the following statement to your CONFIG.SYS file:
  160.                      SHELL=[path]COMMAND.COM /E:xxxxx /P
  161.  
  162.           This method is the optimal solution because it defaults the 
  163.           Environment Buffer to the modified size automatically. at Boot 
  164.           time.  [path] is the optional path to the command processor.
  165.  
  166.     The /E: switch is what actually sets the new Environment Buffer size, 
  167.     and the term 'xxxxx' represents the size that is desired.  The size can 
  168.     be any value in the range indicated in the chart at the start of this 
  169.     section, for the version of DOS you're using.
  170.  
  171.                Examples:  (Method 1) COMMAND=COMMAND.COM /E:1024
  172.                           (Method 2) SHELL=COMMAND.COM /E:1024 /P
  173.  
  174.     The /P switch (optional for method 1) is used to make the new copy of 
  175.     the command processor the permanent one.  This means that once loaded, 
  176.     this copy cannot be terminated with the EXIT command.
  177.  
  178.     For more information on the COMMAND statement, consult your DOS manual. 
  179.  
  180.  
  181.  
  182.                            REGISTRATION AND UPGRADES 
  183.  
  184.     ENVIRO is being released as Shareware.  You may distribute the program 
  185.     freely, as long as you do not alter the program in any way (that 
  186.     includes disassembly, and reverse engineering).  It would also be 
  187.     greatly appreciated if you distributed the archive unchanged.  That is,
  188.     containing all of the files listed at the start of this document.
  189.  
  190.     ENVIRO is not exactly free.  Should you find this to be as handy a tool 
  191.     for getting your other software to work properly, etc., please show 
  192.     your appreciation by registering your copy.  Registered users of ENVIRO 
  193.     are entitled to free upgrades to the program, and will receive a 
  194.     discount when registering any other software I author(ed).  You'll also 
  195.     have the satisfaction of knowing that you're helping to support the 
  196.     availability of inexpensive software. 
  197.  
  198.     I'm not asking for much: a mere $5 will give you that privilege, but if 
  199.     you believe the program is worth more... I won't stop you from sending 
  200.     in a higher amount! <grin>  Please make your check payable to GEORGE 
  201.     SILBERSTERN, and mail it to the following address: 
  202.  
  203.                                George Silberstern
  204.                                1 Makefield Road  #E-184
  205.                                Morrisville, Pa  19067
  206.  
  207.     To obtain the most recent release of ENVIRO directly from me, you may 
  208.     call my BBS, North Eastern Technical Reference [NETRef].  The telephone 
  209.     number is 215/736-1889, and you can connect at 300-14400 baud (USR DS). 
  210.     Once your account has been validated (done online), you will be able to 
  211.     find this program, and any upgrades to it, as well as any other 
  212.     software I have written for public release, in File Area #19.
  213.  
  214.     If you have access to a FidoNet site, you can always File Request the 
  215.     program using the magic name, ENVIRO, from 1:273/214.
  216.  
  217.  
  218.  
  219.                        WARRANTY AND COPYRIGHT INFORMATION
  220.  
  221.          The author of this program shall not be held responsible 
  222.          or accountable, under any circumstance, for the behavior 
  223.          or performance of the program.  Furthermore, neither the 
  224.          author, or any party given permission to distribute this 
  225.          program, shall be held liable or responsible for damages 
  226.          incurred, including the incidental or consequential loss 
  227.          of data, equipment or income, that may result from usage 
  228.          or inability to use this program.  This also implies any 
  229.          data rendered inaccurate, and/or loss sustained by third 
  230.          parties.  These terms apply in all cases and situations,
  231.          even if the author has been advised of the possibilities
  232.          of such damages, or for any claims by any other parties.
  233.  
  234.     All the programs, products, and features thereof, that are mentioned in 
  235.     this documentation, whether included in the following list, or not, are 
  236.     copyrighs and/or trademarked by their respective owners and authors.  
  237.     Any error, or omission from the list is unintentional.  Please refer to 
  238.     the documentation of each product to determine the actual copyright 
  239.     and/or trademark owner(s).
  240.  
  241.     PC-Magazine is a trademark of Ziff-Davis Publishing.  MS-DOS is a 
  242.     product of Microsoft Corporation.  DR-DOS is a product of Digital 
  243.     Research, a division of Novell, Inc.  Turbo Pascal is a trademark of 
  244.     Borland International.  USR is a trademark of U.S. Robotics, Inc.
  245.  
  246.  
  247.  
  248.                                 ABOUT THE AUTHOR
  249.  
  250.     George Silberstern was born and raised in Quito, Ecuador (South 
  251.     America).  He took a passing interest in Computer Science while in High 
  252.     School.  Computers became his hobby (ie. vice) while in College, where 
  253.     he majored in Communications and Foreign Languages, and during his 
  254.     Freshman year, in 1984, discovered Telecomputing and started his first 
  255.     BBS.
  256.  
  257.     While Theatrical Operations became his principal career, he taught 
  258.     himself several Computer programming languages.  In 1987, George began 
  259.     consulting on a freelance basis, primarily developing custom database 
  260.     applications using Clipper (an xBase compiler).
  261.  
  262.     In 1990, he started the North Eastern Technical Reference [NETRef], as 
  263.     a product support BBS for his clients, and as a place where users can 
  264.     obtain help with hardware and software problems.  In 1991, NETRef BBS 
  265.     became a member of FidoNet, and shortly thereafter became the official 
  266.     United States support site for FidoPCB, a Fido to PCBoard Message 
  267.     format converter originating in Europe.
  268.  
  269.     George also authored the following Shareware and/or Public Domain 
  270.     utilities: 
  271.  
  272.         AutoClip   - A group of processing front ends for automating
  273.                      the development of Clipper applications
  274.  
  275.         BIN-to-TXT - Data to Text conversion utility
  276.  
  277.         NetSEND    - An automatic Networking interface for PCBoard
  278.                      BBSes for use with Procomm Plus
  279.  
  280.